Configurando a Integração Sistema Finaz com a API do Tactium IP
Pré-requisitos para ativação do serviço de E-mail no Tactium CRM/OMNI
Sumário
Visão Geral
Para utilização dos servidores de e-mail Gmail e Office 365 para envio e recebimento nos serviços operacionais do Tactium CRM/OMNI é necessário o preenchimento dos requisitos específicos de cada provedor.
Abaixo listamos esses requisitos, que devem ser providenciados pela empresa antes do início da implantação.
Resumo de requisitos
|
|
OFFICE 365 |
|
| Requisito | Observações | O que enviar |
| Instalação do serviço TTSendMailServer para o envio de emails | Saiba mais em: https://docs.tactium.com.br/manuais/instalando-o-servico-de-envio-de-e-mail-ttsendmailserver/ | N/A |
| Organização com conta no Microsoft Azure (Garantir que o Serviço do Office 365 esteja atrelado a conta do Azure) | Saiba mais em: https://azure.microsoft.com/pt-br/ | N/A |
| Aplicativo OAuth criado no portal do Azure da organização | Pedimos que o aplicativo já esteja criado para agilizar o processo de disponibilização do serviço de e-mail. |
Secret ID, ID do aplicativo, ID do Objeto e URI de redirecionamento. ID do Objeto e ID do aplicativo devem comtemplar o código fornecido no caminho |
| API do Office 365 Exchange Online configurada no aplicativo do Azure com consentimento de administrador para os escopos IMAP, POP3 e SMTP | A autenticação OAuth precisa se conectar com os protocolos IMAP, POP ou SMTP para acessar dados de e-mail de usuários Office 365.
Para essa autenticação ocorrer é necessário após a adição dos escopos, conceder a permissão de administrador. |
N/A |
| A utilização do protocolo de segurança TLS exige que a porta de acesso configurada no servidor de saída SMTP seja 587 | Por default, se a conta de e-mail tem por padrão a porta 465, ele não tem suporte para o envio de cliente SMTP AUTH.
Devido a isto para o envio de e-mails ser realizado através do Office 365 é necessário a utilização da porta 587. |
Servidor, porta e criptografia |
| Configuração do servidor de entrada (IMAP/POP3) na conta de e-mail | Servidor, porta e criptografia | |
| Garantir que o usuário com perfil de administrador esteja inserido no Azure Active Directory (Preferencialmente o mesmo usuário deve ser administrador global do Exchange Online) | A pessoa responsável deve ter privilégios suficientes para permitir os escopos e acesso a caixa de entrada. | N/A |
Para mais informações sobre o processo de autenticação OAuth2 do Office 365, acesse Configurando os requisitos do Azure para leitura de e-mail no Tactium OMNI.
|
|
GMAIL |
|
| Requisito | Observações | O que enviar |
| Autenticação Básica: Organização com conta de e-mail no Gmail | N/A | N/A |
| Configuração do servidor de entrada (IMAP/POP3) na conta de e-mail |
N/A |
Servidor, porta e criptografia |
| Configuração do servidor de saída (SMTP) na conta de e-mail |
N/A |
Servidor, porta e criptografia |
| Autenticação OAuth Azure: Organização com conta de e-mail no Gmail | Pedimos que o aplicativo já esteja criado no Azure para agilizar o processo de disponibilização do serviço de e-mail. |
Secret ID, ID do aplicativo, ID do Objeto e URI de redirecionamento. ID do Objeto e ID do aplicativo devem comtemplar o código fornecido no caminho |
| API do Gmail configurada no aplicativo do Azure com consentimento de administrador para os escopos IMAP, POP3 e SMTP | A autenticação OAuth precisa se conectar com os protocolos IMAP, POP ou SMTP para acessar dados de e-mail de usuários Gmail.
Para essa autenticação ocorrer é necessário após a adição dos escopos, conceder a permissão de administrador. |
N/A |
| A utilização do protocolo de segurança TLS exige que a porta de acesso configurada no servidor de saída SMTP seja 587 | Por default, se a conta de e-mail tem por padrão a porta 465, ele não tem suporte para o envio de cliente SMTP AUTH.
Devido a isto para o envio de e-mails ser realizado através do Office 365 é necessário a utilização da porta 587. |
Servidor, porta e criptografia |
| Garantir que o usuário com perfil de administrador esteja inserido no Azure Active Directory (Preferencialmente o mesmo usuário deve ser administrador global do Exchange Online) | A pessoa responsável deve ter privilégios suficientes para permitir os escopos e acesso a caixa de entrada. | N/A |
Configurando para manter uma cópia do e-mail e habilitar o POP3 no Gmail
Dependendo do tipo de servidor de e-mail do cliente é possível habilitar esse recurso de manter um cópia nas configurações do próprio cliente.
Nesse exemplo está sendo explicado/ ilustrado no servidor de e-mail do Gmail (google), precisando configurar na conta de e-mail para manter uma cópia dos e-mails.
Os procedimentos para esta configuração podem variar de servidor para servidor.
Primeiramente precisamos acessar o e-mail cadastrado no serviço e acessar as configurações.
Após abrir a tela de configurações será necessário localizar as configurações do POP e seguir os seguintes passos, no Download POP:
- Em status: Selecionar a opção “Ativar POP para e-mails que chegarem a partir de agora“.
- Quando as mensagens são acessadas com o POP: Selecionar a opção “Manter cópia do e-mail na caixa de entrada.
Depois de configurado, basta salvar as alterações.
Configurando para manter uma cópia do e-mail usando o IMAP
Para utilizar o recurso de manter uma cópia (a nível de aplicação TACTIUM), deve-se atentar para as seguintes configurações no cadastro do serviço:
- Tipo de Protocolo: Deve-se ser “IMAP” (está disponível apenas nessa opção).
- Ação: Informar a opção de “Mover e-mail“, no qual o e-mail irá ser copiado mas não será deletado.
- Pasta destino: Informar o “Nome da pasta” que vai ser criada no servidor de e-mail.
Dependendo do tipo de servidor de e-mail a deleção do e-mail é feita automaticamente, logo após a leitura do mesmo. Portanto, torna-se necessário realizar essas configurações de cópia na aplicação para garantir que os e-mails fiquem na caixa de entrada do cliente.
No POP3, só será liberado a opção de “Deletar e-mail” em “Ação” fazendo com que os e-mails sejam deletados na aplicação, da caixa do e-mail do usuário sem manter uma cópia.
Configurando a pasta da cópia dos e-mails no Microsoft Office 365
Para a configuração no Outlook, será necessário ser feita a criação de uma pasta com o mesmo nome da pasta de destino no cadastro de serviço, como na imagem abaixo:
Note que o nome da pasta deverá ser idêntico ao nome que foi cadastrado no parâmetro “Pasta Destino” do Cadastro de Serviço.
Configurando o link do WebHook (obrigatório)
Se torna necessário a configuração dos links do Webhook para o funcionamento das integrações com as API’s dos canais de messaging (WhatsApp, Telegram, Teams, Facebook, etc) e das pesquisas de satisfação que são associadas juntamente à essa camada de integração. Portanto, deve-se configurar os parâmetros interno e externo em Configurações Gerais no ManagerADM. Para mais informações acesse Configurando o link externo e interno Webhook no TACTIUM.
Configurando a Pesquisa de Satisfação (opcional)
Para habilitar a pesquisa do basta selecionar o tipo de pesquisa no cadastro do serviço no ManagerADM, podendo ser a padrão ou a customizada. Na customizada será habilitado uma nova aba para definir as perguntas necessárias. Para mais informações de como configurar acesse Configurando a pesquisa de satisfação.
Configurando o Serviço no Tactium OMNI
A configuração do serviço deverá ser realizada a partir do CRM Admin. Para mais informações de como realizar esse processo acesse a documentação Realizando a configuração de um serviço de E-mail no Tactium OMNI.
Este conteúdo foi útil para você?
Array